// Copyright 2009 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

/*
Link, typically invoked as ``go tool link'', reads the Go archive or object
for a package main, along with its dependencies, and combines them
into an executable binary.

Command Line

Usage:

    go tool link [flags] main.a

Flags:

    -B note
        Add an ELF_NT_GNU_BUILD_ID note when using ELF.
        The value should start with 0x and be an even number of hex digits.
    -D address
        Set data segment address.
    -E entry
        Set entry symbol name.
    -H type
        Set executable format type.
        The default format is inferred from GOOS and GOARCH.
        On Windows, -H windowsgui writes a "GUI binary" instead of a "console binary."
    -I interpreter
        Set the ELF dynamic linker to use.
    -L dir1 -L dir2
        Search for imported packages in dir1, dir2, etc,
        after consulting $GOROOT/pkg/$GOOS_$GOARCH.
    -R quantum
        Set address rounding quantum.
    -T address
        Set text segment address.
    -V
        Print linker version and exit.
    -X importpath.name=value
        Set the value of the string variable in importpath named name to value.
        This is only effective if the variable is declared in the source code either uninitialized
        or initialized to a constant string expression. -X will not work if the initializer makes
        a function call or refers to other variables.
        Note that before Go 1.5 this option took two separate arguments.
    -a
        Disassemble output.
    -buildid id
        Record id as Go toolchain build id.
    -buildmode mode
        Set build mode (default exe).
    -c
        Dump call graphs.
    -compressdwarf
        Compress DWARF if possible (default true).
    -cpuprofile file
        Write CPU profile to file.
    -d
        Disable generation of dynamic executables.
        The emitted code is the same in either case; the option
        controls only whether a dynamic header is included.
        The dynamic header is on by default, even without any
        references to dynamic libraries, because many common
        system tools now assume the presence of the header.
    -debugtramp int
        Debug trampolines.
    -dumpdep
        Dump symbol dependency graph.
    -extar ar
        Set the external archive program (default "ar").
        Used only for -buildmode=c-archive.
    -extld linker
        Set the external linker (default "clang" or "gcc").
    -extldflags flags
        Set space-separated flags to pass to the external linker.
    -f
        Ignore version mismatch in the linked archives.
    -g
        Disable Go package data checks.
    -importcfg file
        Read import configuration from file.
        In the file, set packagefile, packageshlib to specify import resolution.
    -installsuffix suffix
        Look for packages in $GOROOT/pkg/$GOOS_$GOARCH_suffix
        instead of $GOROOT/pkg/$GOOS_$GOARCH.
    -k symbol
        Set field tracking symbol. Use this flag when GOEXPERIMENT=fieldtrack is set.
    -libgcc file
        Set name of compiler support library.
        This is only used in internal link mode.
        If not set, default value comes from running the compiler,
        which may be set by the -extld option.
        Set to "none" to use no support library.
    -linkmode mode
        Set link mode (internal, external, auto).
        This sets the linking mode as described in cmd/cgo/doc.go.
    -linkshared
        Link against installed Go shared libraries (experimental).
    -memprofile file
        Write memory profile to file.
    -memprofilerate rate
        Set runtime.MemProfileRate to rate.
    -msan
        Link with C/C++ memory sanitizer support.
    -n
        Dump symbol table.
    -o file
        Write output to file (default a.out, or a.out.exe on Windows).
    -pluginpath path
        The path name used to prefix exported plugin symbols.
    -r dir1:dir2:...
        Set the ELF dynamic linker search path.
    -race
        Link with race detection libraries.
    -s
        Omit the symbol table and debug information.
    -shared
        Generated shared object (implies -linkmode external; experimental).
    -tmpdir dir
        Write temporary files to dir.
        Temporary files are only used in external linking mode.
    -u
        Reject unsafe packages.
    -v
        Print trace of linker operations.
    -w
        Omit the DWARF symbol table.
*/

// package main -- go2cs converted at 2022 March 13 06:32:36 UTC
// Original source: C:\Program Files\Go\src\cmd\link\doc.go
namespace go;

} // end main_package
